home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / EXP_TRUE.1 < prev    next >
Encoding:
Text File  |  1996-07-28  |  3.4 KB  |  83 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Export-trueSpace
  3. .SH NAME
  4. exp_true \- trueSpace geometry export filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the trueSpace geometry
  8. export converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a 3D Studio file to trueSpace using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i 3ds -o true filename.3ds
  16. .PP
  17. To convert a Lightwave file to trueSpace and override some of the default 
  18. options in setup.ini:
  19. .IP
  20. pt -i lw -o true -out-true-autofacet-angle = 20 filename.lw
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. The trueSpace geometry export converter writes out a trueSpace 2.0 compatible 
  25. object file, complete with all geometry and material attributes. A file 
  26. exported to trueSpace should render almost exactly as whence the file 
  27. originated (ie: a 3D Studio file exported to trueSpace should render almost 
  28. exactly the same as it would in 3D Studio).
  29. .PP
  30. The following geometry information is output to the file:
  31. .IP
  32. N-sided polygon geometry with recursive holes.
  33. .IP
  34. Texture (u,v) coordinate data.
  35. .IP
  36. All hierarchy information.
  37. .IP
  38. All pivot point information for each object.
  39. .PP
  40. In addition, complete trueSpace materials are output to the file including:
  41. .IP
  42. Surface color, ambient shading coefficient, specular shading coefficient, 
  43. opacity value, highlight size and index of refraction.
  44. .IP
  45. Spherical environment maps, texture maps and bump maps (including the 
  46. (u,v) offset and scaling parameters).
  47. .PP
  48. .SH COMMAND LINE OPTIONS
  49. .PP
  50. The following options are specific to this export converter:
  51. .TP
  52. -o true
  53. This is the mandatory command line option which specifies that the data
  54. is to be exported using the trueSpace format converter.
  55. .TP
  56. -out-true-autofacet-angle = <angle>
  57. This angle determines the cut-off angle between abutting polygons which are to 
  58. appear smooth and those that are to appear faceted. The default is 40 degrees. 
  59. Higher values will make the geometry appear more smooth regardless of how 
  60. angular the data may be whereas smaller values will make the data appear more 
  61. faceted. To change this value within trueSpace enable the 'Inspect Face' 
  62. mouse option, click on an object, then in the 'shader/maps' modeless dialog 
  63. box right click on the 'autoFacet' icon (middle button on the left side).
  64. .PP
  65. .SH Limitations
  66. .PP
  67. The trueSpace file format is rather limiting compared to most 3d binary file 
  68. formats and as such this limits how much information can be output to the trueSpace 
  69. file:
  70. .IP
  71. trueSpace does not really have a 'diffuse Intensity' shading parameter. 
  72. Instead, trueSpace makes the diffuse intensity the inverse (more or less) of 
  73. the specular shininess parameter. This is very limiting when exporting complex 
  74. materials (such as from 3D Studio) to trueSpace. Thus, this export filter 
  75. overcomes this problem by multiplying the inverse of the current database's
  76. diffuse shading coefficient into the specular shading coefficient before being 
  77. output to trueSpace. This allows the diffuse or specular components to dominate, 
  78. but not both.
  79. .IP
  80. trueSpace can only read in bitmap files which use the BMP, Targa or JPEG file formats. 
  81. If any of the exported texture filenames use a different file format than these then 
  82. the export converter will automatically change the file's extension to .tga (Targa format).
  83.